home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / pc_board / pwrlst12.zip / PWRLIST.DOC < prev    next >
Text File  |  1992-08-22  |  11KB  |  242 lines
  1.  
  2.  
  3.  
  4.                ▄▄▄▄▄▄    ▄▄▄▄▄▄   ▄        ▄  ▄▄▄▄▄▄  ▄────▄
  5.                █    ▀▄  ▄█    █▄  █        █  █       █    ▀▄
  6.                █─────▀  █      █  ▀▄  ┌┐  ▄▀  █────   █───▄─▀
  7.                █        ▀█    █▀   ▀▄┌┘└┐▄▀   █       █   ▀▄
  8.                ▀         ▀▀▀▀▀▀     ▀▀  ▀▀    ▀▀▀▀▀▀  ▀    ▀
  9.  
  10.                         ▄        ▄   ▄▄▄▄▄▄  ▄▄▄▄▄▄▄
  11.                         █        █  █▀    ▀     █
  12.                         █        █  ▀─────▄     █
  13.                         █        █  ▄    ▄█     █
  14.                         ▀▀▀▀▀▀▀  ▀  ▀▀▀▀▀▀      ▀
  15.  
  16.  
  17.                               version  1.0
  18.  
  19.                                    by
  20.  
  21.                               Mike Weaver
  22.  
  23.  
  24.                           !!!!! DISCLAIMER !!!!!
  25.  
  26. This program and all other files associated with it are not guaranteed to be
  27. bug free or virus free. Everything possible has been done to insure your
  28. safety and reliability. I, nor my BBS are responsible for any damages of any
  29. kind, including profit loses and data loss, that relate directly or
  30. indirectly to these programs and files.  You may distribute this program, as
  31. long as it is in unmodified form with all the files originally included.
  32.  
  33.                                  OVERVIEW
  34.  
  35. Power List is a utility for PCBoard 14.x, although it has not been tested
  36. on any other systems it should work fine with any system that can produce
  37. a DOOR.SYS or PCBOARD.SYS file.
  38.  
  39. Power List allows the user to design and download a custom built list of
  40. available files on a particular BBS. Hence the name.  Rather than tying up
  41. your system to download a very large complete file listing the user selects
  42. those files areas that interest him/her and then Power List will do the rest.
  43.  
  44. Using PKZip(tm) Power List will compress all the selected file directories
  45. and then using DSZ(tm) it will allow the user to download the list.
  46.  
  47. List of Files in archive:
  48.                          Adopt.scr
  49.                          Sample.cfg
  50.                          Pwrlist.doc
  51.                          Pwrlist.exe
  52.                          Pwrlist.hlp
  53.                          Pwrlist.
  54.                          File_id.diz
  55.                          NiteLite.txt
  56.                          History.doc
  57.  
  58. ADOPT.SCR     This is a screen that you use to ask your users for help
  59.               by adopting this or any other of your doors.  You can edit
  60.               this file if you like, however it MUST! reside in the same
  61.               directory as the other files from this archive or the door
  62.               will puke!
  63.  
  64. SAMPLE.CFG    This is the door configuration file.  The one included in
  65.               this archive is a sample and will have to be edited to fit
  66.               your system.
  67.  
  68. PWRLIST.DOC   Three guesses and the first 2 don't count. <Grin>
  69.  
  70. PWRLIST.EXE   The executable door program itself.  This door is a stand
  71.               alone program that requires no other files such as DoorPatch
  72.               or Brun. I wrote this door using DoorSource 4.0.
  73.  
  74. PWRLIST.HLP   The help file for the user when he/she invokes the help
  75.               command while in the door.  The program checks this file
  76.               for size as well as for integrity so don't edit this one.
  77.  
  78. PWRLIST.      This is a sample batch file to run the door on PCBoard
  79.               systems.  You may have to edit it depending on where you
  80.               store the door files etc.
  81.  
  82. FILE_ID.DIZ   This file contains program descriptions for boards that
  83.               implement automatic file description insertion with a
  84.               program such as PCBDescribe(tm).
  85.  
  86. NITELITE.TXT  This is a small ad for my BBS.
  87.  
  88. HISTORY.DOC   A list of corrections or bug fixes or changes in Power List
  89.  
  90. Configuration file setup:
  91.  
  92.    Line 1 ->            c:\pcb\pcboard.sys
  93.    Line 2 ->            The Nite-Lite bbs
  94.    Line 3 ->            Mike
  95.    Line 4 ->            Weaver
  96.    Line 5 ->            662345922
  97.    Line 6 ->            c:\pcb\menus\dirs
  98.    Line 7 ->            c:\pcb\gen\           <- trailing backslash a must!
  99.    Line 8 ->            60
  100.    Line 9 ->            dos1
  101.          thru           dos2
  102.          whatever       dos3
  103.                         dos4
  104.                         dos5
  105.                         dos6
  106.                         dos7
  107.                         etc.
  108.                         etc.
  109.                         etc.
  110.  
  111. Line 1 ->  Is the location of your pcboard.sys file. The program requires
  112.            the complete path and filename.
  113.  
  114. Line 2 ->  The name of your BBS goes here.
  115.  
  116. Line 3 ->  The SysOp's first name.
  117.  
  118. Line 4 ->  The SysOp's last name
  119.  
  120. Line 5 ->  This is where you put your serial number once you register the
  121.            program.  Until then use any 9 digit number you like but don't
  122.            leave this line out or the door will crash!
  123.  
  124. Line 6 ->  This is the location of your file directory menu.  The example
  125.            above is from my system, use whatever you use in PCBSetup.
  126.  
  127. Line 7 ->  This is the hard drive directory path to your individual files
  128.            directories.  In other words the directory where the dir files
  129.            are stored.  !! Important !!  The trailing backslash is a must!
  130.  
  131. Line 8 ->  This number represents the total number of dir files on your
  132.            system.  The unregistered version will handle only 99 dir files.
  133.  
  134. Line 9 ->  From here to the end of the .cfg file is where you tell the
  135.            program the name of each of your systems dir files.  Using this
  136.            method seemed more versatile to me.  The unregistered version
  137.            will only read the first 100 entries.  If you need more than
  138.            that then guess what you need to do?
  139.  
  140. Command line options:
  141. --------------------
  142.         Power List has numerous command line options in order to provide
  143.         flexibility with most computer systems. Here is a list:
  144.  
  145.                 LOCKED:xxxxx  - Forces Power List to lock the modem at the
  146.                                 speed given.
  147.                 LOCAL         - Forces Power List to run in local mode. This
  148.                                 is really meant for testing purposes, but it
  149.                                 still reads the configuration file, but doesn't
  150.                                 read the bbs interface file.
  151.                 NETWORK       - Forces file sharing to be active incase you
  152.                                 are using something other than SHARE to manage
  153.                                 file locking.
  154.                 IRQ=n         - Lets you change the IRQ used for the com port
  155.                                 specified in the bbs interface file.
  156.                                 (See below for more information)
  157.                 ADDR=&Hnnnn   - Lets you change the address used for the com
  158.                                 port specified in the bbs interface file.
  159.                                 (See below for more information)
  160.                 PS2           - Forces the PS/2 IRQs and addresses if a PS/2
  161.                                 isn't detected (Normally it is, but you can't
  162.                                 always tell!)
  163.                 RBBS          - Forces Power List into RBBS/QBBS mode
  164.                 WILDCAT       - Forces Power List into Wildcat 2.0 mode
  165.                 DOORSYS       - Forces Power List into 31-Line DOOR.SYS mode
  166.                 PCB121        - Forces Power List into PCBoard 11.8/12.x mode
  167.                                 with COM 1 active
  168.                 PCB122        - Forces Power List into PCBoard 11.8/12.x mode
  169.                                 with COM 2 active
  170.                 PCB14         - (DEFAULT) Forces Power List into PCBoard 14.x
  171.                                 mode
  172.  
  173.         When you use the IRQ or the ADDR option, you must include the other.
  174.         You can't use just the IRQ and not the ADDR, and you can't use just
  175.         the ADDR and not the IRQ. Here's a chart with the STANDARD IRQs
  176.         and addresses for the PS/2s and IBM PCs:
  177.                                 Non PS/2
  178.                 Com port       IRQ     Address
  179.                    1             4       &H3F8
  180.                    2             3       &H2F8
  181.                    3             4       &H3E8
  182.                    4             3       &H2E8
  183.                   5-8            4       &H3F8
  184.  
  185.                                 PS/2
  186.                 Com port       IRQ     Address
  187.                    1             4       &H3F8
  188.                    2             3       &H2F8
  189.                    3             3       &H3220
  190.                    4             3       &H3228
  191.                    5             3       &H4220
  192.                    6             3       &H4228
  193.                    7             3       &H5220
  194.                    8             3       &H5228
  195.  
  196.  
  197. Batch file setup:
  198.  
  199.                 d:                     -> Change to the drive where files are.
  200.                 cd\pwrlist             -> Change to PowerList directory
  201.                 pwrlist pwrlist.cfg    -> Run PowerList
  202.                 c:                     -> Change back to BBS drive
  203.                 cd\pcb                 -> Change back to BBS directory
  204.                 board                  -> Reload the BBS
  205.  
  206.  
  207. Function key values:
  208.  
  209.                   F3  - Printer toggle
  210.                   F4  - Page bell toggle
  211.                   F5  - Shell to DOS
  212.                   F7  - Caller alarm toggle
  213.                   F8  - Return caller to board
  214.                   F10 - Start sysop chat
  215.                   ESC - Enter sysop chat
  216.                 ALT-X - Drop to DOS after caller logs off
  217.                 ALT-N - Sysop next on flag
  218.  
  219. One last thing I am terrible at writing so if these docs seem hard to read
  220. or use it is probably because they are. <GRIN>
  221.  
  222. Registration:
  223.               I have not crippled this program in any way, so you can use it
  224.               forever if you like.  However be forewarned that unless you
  225.               register I may not be apt to answer questions as freely.  I
  226.               too however realize the cost of running a BBS so I ask only a
  227.               mere $10 if you like and use the program.  If you do not like
  228.               the program and have an idea that would make it more likeable
  229.               by all means let me know and I will try to implement it.
  230.  
  231.               Bug reports or problems can be left on my bbs at 615-458-9099
  232.  
  233.  
  234.                      OK I'm finished, send the millions to:
  235.  
  236.                                 Mike Weaver
  237.                                 % The NITE-LITE bbs
  238.                                 Rt. 1 Box 231b
  239.                                 New Macedonia Church Rd.
  240.                                 Philadelphia, Tn.
  241.                                                37846
  242.